home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / GetUid.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  2.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____GGGGeeeettttUUUUiiiidddd((((3333))))                 TTTTkkkk (((( ))))                  TTTTkkkk____GGGGeeeettttUUUUiiiidddd((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_GetUid, Tk_Uid - convert from string to unique identifier
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  15.  
  16.           ####ttttyyyyppppeeeeddddeeeeffff cccchhhhaaaarrrr ****TTTTkkkk____UUUUiiiidddd
  17.  
  18.           Tk_Uid
  19.           TTTTkkkk____GGGGeeeettttUUUUiiiidddd(_s_t_r_i_n_g)
  20.  
  21.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  22.           char*_s_t_r_i_n_g(in)
  23.           String for  which  the  corresponding  unique  identifer  is
  24.           desired.
  25.      _________________________________________________________________
  26.  
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           TTTTkkkk____GGGGeeeettttUUUUiiiidddd returns the  unique  identifier  corresponding  to
  30.           _s_t_r_i_n_g.   Unique  identifiers  are similar to atoms in Lisp,
  31.           and are used in Tk to speed up comparisons and searches.   A
  32.           unique  identifier (type Tk_Uid) is a string pointer and may
  33.           be used anywhere that a variable of type ``char *'' could be
  34.           used.  However, there is guaranteed to be exactly one unique
  35.           identifier for any given  string  value.   If  TTTTkkkk____GGGGeeeettttUUUUiiiidddd  is
  36.           called twice, once with string _a and once with string _b, and
  37.           if _a and _b have the same string value (strcmp(a, b)  ==  0),
  38.           then TTTTkkkk____GGGGeeeettttUUUUiiiidddd will return exactly the same Tk_Uid value for
  39.           each call (Tk_GetUid(a) == Tk_GetUid(b)).  This  means  that
  40.           variables  of  type Tk_Uid may be compared directly (x == y)
  41.           without having to call  ssssttttrrrrccccmmmmpppp.   In  addition,  the  return
  42.           value  from TTTTkkkk____GGGGeeeettttUUUUiiiidddd will have the same string value as its
  43.           argument (strcmp(Tk_GetUid(a), a) == 0).
  44.  
  45.  
  46.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  47.           atom, unique identifier
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.